added samples
[windows-sources.git] / sdk / samples / all in on code / Visual Studio 2010 / VBAzureBingMaps / ReadMe.htm
blobb29e5da9466134e1185499614b3dfe3834e5d8db
1 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
2 <html xmlns="http://www.w3.org/1999/xhtml" >
3 <head>
4 <title>Read Me</title>
5 </head>
6 <body>
8 <h3>
9 Overview</h3>
10 <p>
11 This is the source code for the AzureBingMaps sample. You can find a series of
12 blog posts describing on
13 <a href="http://blogs.msdn.com/b/windows-azure-support/archive/2010/08/11/bring-the-clouds-together-azure-bing-maps.aspx">
14 http://blogs.msdn.com/b/windows-azure-support/archive/2010/08/11/bring-the-clouds-together-azure-bing-maps.aspx</a>.
15 We encourage you to read the blog posts first, and use the source code as a
16 reference.</p>
17 <h3>
18 System Requirements</h3>
19 <p>
20 To build and run this sample, you need the following software:</p>
21 <ul>
22 <li>Visual Studio 2010 and .NET 4</li>
23 <li>Windows Azure SDK v1.4:
24 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=7a1089b6-4050-4307-86c4-9dadaa5ed018&amp;displaylang=en">
25 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=7a1089b6-4050-4307-86c4-9dadaa5ed018&amp;displaylang=en</a></li>
26 <li>Windows Azure AppFabric SDK 1.0 RTM:
27 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=39856a03-1490-4283-908f-c8bf0bfad8a5&amp;displaylang=en">
28 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=39856a03-1490-4283-908f-c8bf0bfad8a5&amp;displaylang=en</a></li>
29 <li>Windows Azure AppFabric Labs SDK:
30 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=D89640FC-C552-446E-AEAD-B1E0D940F31B">
31 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=D89640FC-C552-446E-AEAD-B1E0D940F31B</a></li>
32 <li>Windows Server AppFabric:
33 <a href="http://www.microsoft.com/downloads/en/details.aspx?displaylang=en&amp;FamilyID=467e5aa5-c25b-4c80-a6d2-9f8fb0f337d2">
34 http://www.microsoft.com/downloads/en/details.aspx?displaylang=en&amp;FamilyID=467e5aa5-c25b-4c80-a6d2-9f8fb0f337d2</a></li>
35 <li>Windows Identity Foundation Runtime:
36 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=eb9c345f-e830-40b8-a5fe-ae7a864c4d76">
37 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=eb9c345f-e830-40b8-a5fe-ae7a864c4d76</a></li>
38 <li>Windows Identity Foundation SDK:
39 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=c148b2df-c7af-46bb-9162-2c9422208504">
40 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=c148b2df-c7af-46bb-9162-2c9422208504</a></li>
41 <li>Windows Live SDK:
42 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9bc1e29e-3c0c-48b8-8148-5629c265300c">
43 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=9bc1e29e-3c0c-48b8-8148-5629c265300c</a></li>
44 <li>Silverlight 4 SDK:
45 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=b3deb194-ca86-4fb6-a716-b67c2604a139&amp;displaylang=en">
46 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=b3deb194-ca86-4fb6-a716-b67c2604a139&amp;displaylang=en</a></li>
47 <li>Bing Maps Silverlight SDK:
48 <a href="http://www.microsoft.com/downloads/en/details.aspx?displaylang=en&amp;FamilyID=beb29d27-6f0c-494f-b028-1e0e3187e830">
49 http://www.microsoft.com/downloads/en/details.aspx?displaylang=en&amp;FamilyID=beb29d27-6f0c-494f-b028-1e0e3187e830</a></li>
50 <li>Windows Phone SDK: <a href="http://create.msdn.com/en-us/home/getting_started">
51 http://create.msdn.com/en-us/home/getting_started</a></li>
52 <li>Windows Phone SDK October update:
53 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=49b9d0c5-6597-4313-912a-f0cca9c7d277">
54 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=49b9d0c5-6597-4313-912a-f0cca9c7d277</a></li>
55 <li>Windows Phone SDK VB pack:
56 <a href="http://www.microsoft.com/downloads/en/details.aspx?FamilyID=4e97ea70-e479-4c05-814f-639d71690e5d&amp;displaylang=en">
57 http://www.microsoft.com/downloads/en/details.aspx?FamilyID=4e97ea70-e479-4c05-814f-639d71690e5d&amp;displaylang=en</a></li>
58 <li>OData for Windows Phone:
59 <a href="http://odata.codeplex.com/releases/view/54698#DownloadId=161862">
60 http://odata.codeplex.com/releases/view/54698#DownloadId=161862</a></li>
61 <li>SQL Server 2008 or R2 for local simulation (Note, SQL Server 2005 doesn&#39;t
62 support spatial data, so 2008 is required)</li>
63 <li>A modern web browser such as IE 9</li>
64 <li>Valid accounts for Windows Azure, Bing Maps, and Windows Live Messenger Connect.</li>
65 </ul>
66 <h3>
67 Projects</h3>
68 <p>
69 There&#39;re 6 projects in the solution:</p>
70 <ul>
71 <li>AzureBingMaps: The Windows Azure cloud project.</li>
72 <li>AzureBingMaps.WebRole: The Web Role project. It contains the following
73 components:<ul>
74 <li>A WCF Data Services: Under the DataService folder.</li>
75 <li>A HTML client: The HTML markup is defined in HtmlClient.aspx, while the
76 JavaScript code is in Scripts\HtmlClient.js.</li>
77 <li>Federation related code: Including LoginPage, FederationCallbackHandler,
78 WindowsLiveProfile, and code behind for the HTML/Silverlight clients.</li>
79 </ul>
80 </li>
81 <li>AzureBingMaps.DAL: The data access project, including SQL scripts and Entity
82 Framework code.</li>
83 <li>AzureBingMaps.UnitTest: A unit test project.</li>
84 <li>SilverlightClient: The Silverlight client.</li>
85 <li>WindowsPhoneClient: The Windows Phone client.</li>
86 </ul>
87 <h3>
88 Configurations</h3>
89 <p>
90 To build and run the solution, you must modify the configurations to provide
91 your own Azure, Bing Maps, and Windows Live Messenger Connect information.
92 There&#39;re totally 7 places to modify:</p>
93 <ul>
94 <li>In ServiceDefinition.vbcfg of AzureBingMaps, configure Windows Azure storage
95 account, remote desktop credential, SSL certificate, and remote desktop
96 certificate.</li>
97 <li>In Web.config of AzureBingMaps.WebRole, configure SQL Azure connection string,
98 Windows Live Messenger Connect information, the Windows Azure service domain,
99 the AppFabric namespace, the AppFabric caching credential, machine key, WIF
100 certificate, AppFabric ACS certificate.</li>
101 <li>In Scripts\HtmlClient.js of AzureBingMaps.WebRole, configure Bing Maps
102 credential.</li>
103 <li>If you want to do unit test, configure connection string in App.config in
104 AzureBingMaps.UnitTest.</li>
105 <li>In MainPage.xaml.vb of SilverlightClient, configure Bing Maps credential.</li>
106 <li>In MainPage.xaml.vb of WindowsPhoneClient, configure Bing Maps credential.</li>
107 <li>In DataSource.vb of WindowsPhoneClient, configure WCF Data Services address.</li>
108 </ul>
111 In addidion, certain SDKs (such as Windows Live and AppFabric Labs) will not
112 install the required assemblies in GAC. So after you downloaded the SDKs, you
113 may need to modify project references to reference the correct assemblies.
114 </p>
116 </body>
117 </html>